home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / brltty / README-ATB < prev    next >
Text File  |  2009-05-14  |  2KB  |  68 lines
  1. Attributes Tables
  2. -----------------
  3.  
  4. Files with names of the form *.atb are attributes tables, and with names of the 
  5. form *.ati are attributes subtables. They are used when BRLTTY is displaying 
  6. screen attributes rather than screen content. Each of the eight braille dots 
  7. represents one of the eight VGA attribute bits.
  8.  
  9. An attributes table consists of a sequence of directives, one per line, which 
  10. define how combinations of VGA attributes are to be represented in braille. 
  11. UTF-8 character encoding must be used. White-space (blanks, tabs) at the 
  12. beginning of a line, as well as before and/or after any operand of any 
  13. directive, is ignored. Lines containing only white-space are ignored. If the 
  14. first non-white-space character of a line is "#" then that line is a comment 
  15. and is ignored.
  16.  
  17. ===============================================================================
  18.  
  19. The Dot Directive
  20. -----------------
  21.  
  22.    dot <dot> <state> # <comment>
  23.  
  24. Use the "dot" directive to specify what a specific dot represents. The default 
  25. is that all dots are down and not used to represent anything.
  26.  
  27. The <dot> operand specifies the dot being defined. It is a single digit within 
  28. the range 1-8 as defined by the standard braille dot numbering convention (see 
  29. README-DOTS).
  30.  
  31. The <state> operand specifies what the dot represents. It may be:
  32. *  =attribute  The dot is raised if the named attribute is on.
  33. *  ~attribute  The dot is raised if the named attribute is off.
  34.  
  35. The names of the attribute bits are:
  36. *  0X01  fg-blue
  37. *  0X02  fg-green
  38. *  0X04  fg-red
  39. *  0X08  fg-bright
  40. *  0X10  bg-blue
  41. *  0X20  bg-green
  42. *  0X40  bg-red
  43. *  0X80  blink
  44.  
  45. Examples:
  46.  
  47.    dot 1 =fg-red
  48.    dot 2 ~bg-blue
  49.  
  50. ===============================================================================
  51.  
  52. The Include Directive
  53. ---------------------
  54.  
  55.    include <file> # <comment>
  56.  
  57. Use the "include" directive to include the content of an attributes subtable. 
  58. It is recursive, which means that any attributes subtable can itself include 
  59. yet another attributes subtable. Care must be taken to ensure that an "include
  60. loop" is not created.
  61.  
  62. The <file> operand specifies the file to be included. It may be either a 
  63. relative or an absolute path. If relative, it is anchored at the directory 
  64. containing the including file.
  65.  
  66. ===============================================================================
  67.  
  68.